home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr31 / acs_v100.zip / MANUAL.ACS < prev   
Text File  |  1993-04-14  |  14KB  |  483 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10. ==============================================================================
  11.  
  12.  
  13.  
  14.  
  15.  
  16.   PROGRAM MANUAL - Archive Converter/Scanner
  17.  
  18.       ▌
  19.      ▌▌▌
  20.     ▌▌ ▌▌                                   (C) 1990, Vikram Rao
  21.    ▌▌▌▌▌▌▌   ▌▌▌▌▌
  22.    ▌▌   ▌▌  ▌▌   ▌▌
  23.             ▌▌                        Documentation (C) 1990, Nick Itsou
  24.             ▌▌   ▌▌   ▌▌▌▌▌
  25.              ▌▌▌▌▌   ▌▌
  26.                       ▌▌▌▌
  27.                          ▌▌
  28.     Version 1.0α     ▌▌▌▌▌
  29.   (July 1st, 1990)
  30.  
  31.  
  32.  
  33.  
  34.  
  35. ==============================================================================
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                            i
  61.  
  62.  
  63.  
  64.  
  65.                              Table of Contents
  66.                              ~~~~~~~~~~~~~~~~~
  67.  
  68.  
  69.  
  70.     Agreement Notice..............................................iii
  71.  
  72.     Disclaimer....................................................iii
  73.  
  74.     Support BBS...................................................iii
  75.  
  76.     Introduction to A.C.S.........................................iv
  77.  
  78.     Seting up A.C.S...............................................1
  79.  
  80.     Usage.........................................................3
  81.  
  82.     Thanks........................................................4
  83.  
  84.     Copyrights....................................................4
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                    ii
  121.  
  122.  
  123.  
  124.  
  125.                             Agreement Notice
  126.                             ~~~~~~~~~~~~~~~~
  127.  
  128.    This software may be freely distributed in the Public Domain so long as
  129. the software and accompanying documentation remain unmodified and *NO* fee
  130. or consideration has been paid to obtain the ACS Software Package.  All we
  131. ask is that you take the time to give the ACS Support BBS a call and leave
  132. us (Vic Rao or Nick Itsou) a message containing your comments/suggestions!
  133.  
  134.  
  135.  
  136.   
  137.                                 Disclaimer
  138.                                 ~~~~~~~~~~
  139.  
  140.     We are NOT responsible for any damage caused by your use (or inability
  141. to use) ACS. Use this software at your own risk!  Read these Docs FULLY!!.
  142.  
  143.  
  144.  
  145.                                 Support BBS
  146.                                 ~~~~~~~~~~~
  147.  
  148.           Call the support BBS: Helicon BBS
  149.                                 (416)282-0701
  150.                                 1:250/490
  151.                                 Sysop: Nick Itsou
  152.            
  153.           Direct all questions to Nick Itsou or Vic Rao.
  154.           File request magic name ACS for latest versions of the 
  155.                            Archive Converter/Scanner
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                                    iii
  181.  
  182.  
  183.  
  184.  
  185.  
  186. Introduction to A.C.S.
  187. ~~~~~~~~~~~~~~~~~~~~~~
  188.  
  189. What is A.C.S.?  Well, A.C.S. is short for Archive Converter/Scanner.  It
  190. has been in existence for about one or two years, and only now, do we
  191. realize the actual potential of this program, and have decided to
  192. distribute it.  The purpose behind A.C.S. is to allow a Sysop, or user, to
  193. check on any directory which has unscanned files in it.  This allows the
  194. user to relieve himself of the time it would take to manually check
  195. through all the files, and allow the computer to do it all automatically.
  196. After the program unarchives the file, it does a viral scan of the
  197. unarchived files, and then after successful scanning, re-archives the file
  198. into any desired archive format.    
  199.  
  200. How did it come about?  Well, to put it shortly, I'm very lazy, actually,
  201. I like to sleep at reasonable hours (By the way, I'm writing this at 3am).
  202. Being a Sysop, however, has certain responsibilities, which include
  203. checking up on daily uploads for viruses.  This can be a long and tedious
  204. process, especially if you re-archive all new files into a standard
  205. preference, as I do.  I found this would take at least two hours a night
  206. to do, so tended to leave all the work until the weekend.  However, by
  207. that time, the workload was just too great to handle, and I had wished
  208. that I had done it when I should have.  
  209.  
  210. Now, to make life simpler, I asked a friend of mine, Vic, who I knew was
  211. just dying to write a program for me (yah right =) to whip something up
  212. that could unarchive all the new files I had received, check them for
  213. viruses, and then re-archive them to a specified format.  Well, it so
  214. happened, that Vic had a skeletal version of the final product lying
  215. around, that he had been using for his own personal use (isn't he greedy?
  216. =)  
  217.  
  218. After we had sat down and discussed in depth what we both wanted in the
  219. program, Vic sat down to write a final product.  And thus came about
  220. A.C.S.
  221.  
  222.  
  223.  
  224. Requirements
  225. ~~~~~~~~~~~~
  226.  
  227. This program can be run on any IBM class machine, PC upward with a minimum
  228. of 256 kb Ram and a Hard Drive.  It is NOT recomended that this program be
  229. used in a multi-tasking environment, as the environment may be
  230. tremendously slowed, due to intense disk access and interrupt calling,
  231. which may cause a computer lock-up.
  232.  
  233.         
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                     iv
  241.  
  242.  
  243.  
  244. Setting Up A.C.S
  245. ~~~~~~~~~~~~~~~~
  246.  
  247. Setting up A.C.S is a very simple task.  All that it requires is that you
  248. use the command line:   acs -c
  249.  
  250. Upon entering this command line, A.C.S. will open with a disclaimer sceen.
  251. The second screen presented to you is the actual configuration menu.  This
  252. is what it looks like:
  253. --------------------------------------------------------------------------
  254. Actual ACS Program/Code (C) 1990.  Vikram Rao +Call The ACS Support Board+ 
  255. Documentation Copyright (C) 1990.  Nick Itsou +(416)282-0701  (1:250/490)+
  256.  
  257. Archive Converter/Scanner vxx -=[Official PD Release]=- Compiled On [xxxx]
  258.  
  259. ACS CONFIG: (ESC To Save & Exit or # To Modify Directory Value)
  260. ~~~~~~~~~~
  261.          1 ...Directory To Use For a Temporary ACS Working Directory
  262.                 > C:\ARCFILES\TEMP
  263.  
  264.          2 ...Directory To Find The Archives To Be Converted/Scanned
  265.                 > C:\ARCFILES
  266.  
  267.          3 ...Directory To Find The Main ACS.EXE & The ACS.CNF Files
  268.                 > C:\ACSFILES
  269.  
  270.          4 ...Directory To Back-Up The 'Old' Arcs To As A Precaution
  271.                 > C:\BACKUPS
  272.  
  273. --------------------------------------------------------------------------
  274. To configure A.C.S., you must enter the directories you wish for the
  275. A.C.S.  program to use.  There are only four directories required, and of
  276. those four, you are only required to create two.
  277.  
  278. Directory one is the Temporary Work Directory.  This is where A.C.S. does
  279. all it's un-archiving, scanning, and re-archiving.  This is a required
  280. directory, but A.C.S. constructs this directory as it runs and removes it
  281. after completion.
  282.  
  283. Directory two is the Supply Directory where all the files to be converted
  284. and scanned are found.  This directory is mandatory, and MUST exist before
  285. A.C.S is executed.  If this directory does not exist, A.C.S. will exit
  286. with an apropriate error message, or possibly do worse.  Vic has tried to
  287. make it as graceful as possible, but it might screw up.  (This hasn't yet
  288. happened in the 15 meg of testing that I've performed on it though. =)
  289.  
  290. Directory three is the Main Program Directory where ALL the A.C.S. files
  291. must be located.  A.C.S. requires and depends on various external files.
  292. These files must exist for A.C.S. to work flawlessly, and MUST be included
  293. in this directory.  No path may be given to use these files, as the A.C.S.
  294. doesn't utilize a path.  This directory MUST exist before execution of
  295. A.C.S., as it is where the computer finds ACS.EXE, the ACS-WORK.LOG, and
  296. ACS.CFG.  This directory, however, can be used in a path, so that you can
  297. start A.C.S. from anywhere in your hard drive.
  298.  
  299.  
  300.                                     1
  301.  
  302.  
  303.  
  304.  
  305.  
  306. **** WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING ****
  307.  
  308. A.C.S. runs in conjunction with several programs.  If you are missing at
  309. least one of those programs A.C.S will not execute, as it checks to make
  310. sure those files are in the A.C.S directory.  If you wish to run A.C.S.
  311. without one of these files, you can fudge, and create a dummy file with
  312. the appropriate filename which is at least 1 byte in size. (Via Copy Con)
  313.  
  314. The files A.C.S. requires for use are as follows:
  315.  
  316. Scan.exe 
  317. Pkzip.exe/Pkunzip.exe
  318. Lharc.exe
  319. Zoo.exe
  320. Pkpak.exe/Pkunpak.exe
  321. Pak.exe
  322.         
  323. These files, along with ACS.EXE and ACS.CNF, MUST exist in directory three,
  324. as this is the directory which is read to find the files to execute the
  325. operation.   
  326.  
  327. ***************************************************************************
  328.  
  329.  
  330. Directory four is the Backup directory.  This is where all ORIGINAL files
  331. to be checked are copied.  The files backed up are in original format, and
  332. have NOT been scanned or converted.  This is for your own safety, and is
  333. a feature which we encourage you to use.  Don't blame us if you don't, and
  334. end up losing all your files.  This directory does not need to exist, and
  335. will be created if the backup option is selected.  If this directory
  336. already exists, A.C.S. will use the existing directory.
  337.  
  338. After you configure the directories to your own personal setup, you press
  339. ESC and exit the configuration set up.  A.C.S. will create a configuration
  340. file called ACS.CNF, which is a simple text file with the directories
  341. listed in it.
  342.  
  343.  
  344.  
  345. **** WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING ****
  346.  
  347. ACS is capable of using a directory nesting as deep as DOS will allow, so
  348. it is possible for you to use several sub-directories.  Your best bet is
  349. to use the default configuration, and create the required directories.
  350.  
  351. ACS has the capability to totally erase a hard drive, IF the root
  352. directory is used as the temporary work directory, so BE CAREFUL in your
  353. configuration.
  354.  
  355. ***************************************************************************
  356.  
  357.  
  358.  
  359.  
  360.                                     2
  361.  
  362.  
  363.  
  364. Usage
  365. ~~~~~
  366.  
  367. Usage of A.C.S. is very simple, and similar to many Archiving programs.
  368. The basic command line for A.C.S. is:
  369.  
  370.         acs -[option] -[option] -[option] -F[filename.ext]
  371.  
  372. The options available to A.C.S. are labeled as follows:
  373.  
  374.        -A  Execute the A.C.S. program.  This MUST be included to run
  375. A.C.S. or it will display a usage screen and an error message, then fall
  376. back to DOS.
  377.  
  378.        -B  Backup original archives to specified backup directory.  This
  379. is a safety precaution for all you paranoid types who don't trust us.  =)
  380. Actually, this can come in handy so that you know exactly what on your HD
  381. must still be backed up to floppy.  This only backs up the ORIGINAL format
  382. of the file before A.C.S. starts working on the file.
  383.  
  384.        -C  Configure A.C.S.  This is the option you add to run the
  385. configuration program.  If you include this with any other options, A.C.S.
  386. will allow you to configure it, then fall back to DOS, making sure that
  387. you have indeed configured it.  If included A.C.S. will not scan and
  388. re-archive any files.
  389.  
  390.        -K  Kill files containing viruses.  This option allows you to
  391. configure A.C.S. to destroy a file if it finds a virus, as noted by SCAN,
  392. within it.  It also notifies you in the ACS-WORK.LOG, if the log option is
  393. enabled.
  394.  
  395.        -L  Enable ACS-WORK.LOG.  This causes A.C.S. to write into a log
  396. all successful and unsuccessful operations, as well as including error
  397. messages and virus warnings.  This option is encouraged, as it keeps you
  398. up to date with what has been verified.  The file is a straight ASCII text
  399. file called ACS-WORK.LOG.
  400.  
  401.         -1  Final method of re-archiving -- ARC.
  402.         -2  Final method of re-archiving -- LZH.
  403.         -3  Final method of re-archiving -- PAK.
  404.         -4  Final method of re-archiving -- ZIP.
  405.         -5  Final method of re-archiving -- ZOO.
  406.  
  407. Options 1 through 5 are the final method which A.C.S. uses to re-archive
  408. the file.  The final method is chosen for personal preference, and should
  409. reflect the method which you like your archives to be stored.  This option
  410. is mandatory, as is option -A, or A.C.S. will exit with the usage screen
  411. and error message, and fall back to DOS.  This is how you tell A.C.S. what
  412. the final method will be in re-archiving the file it has just checked.
  413.  
  414.         -F[filename.ext]  This is used to run A.C.S. for specific files
  415. only.  Filename.ext may consist of any wildcards.  For instance, if you
  416. wanted to run A.C.S. on LZH files only, you would include this option in
  417. the command line:  -F*.lzh   There may be NO spaces between -F and the
  418. filename. The Default is -F*.*, if no -F[Wildcard] is given by the user.
  419.  
  420.                                 3
  421.  
  422.  
  423.  
  424.  
  425. Some examples of use:
  426.  
  427.         ACS -C               [configure A.C.S.]
  428.         ACS -A -1            [execute A.C.S. with final archives in ARC format]
  429.         ACS -A -B -L -4      [execute A.C.S. backup original files, append to
  430.                               ACS-WORK.LOG, and re-archive in ZIP format]
  431.         ACS -A -K -4 -F*.ZOO [execute A.C.S. on ZOO files only, erasing
  432.                               infected files and re-archive in ZIP format]
  433.  
  434.  
  435.  
  436. Thanks
  437. ~~~~~~
  438.  
  439. We thank you deeply for your support, and depending on the response, new
  440. versions will be created for distribution.  If no response is met, then no
  441. further versions will be developed for Public Distribution.  We'd
  442. appreciate any comments and suggestions, directed to us (Vic Rao or Nick
  443. Itsou) through the A.C.S. Support BBS, mentioned above.
  444.  
  445.  
  446.  
  447. Copyrights
  448. ~~~~~~~~~~
  449.  
  450. In NO way, does A.C.S. change the coding of the software it works in
  451. conjunction with.  All versions tested with are listed.  Many thanks to
  452. the writers of the programs for creating excellent archive and virus
  453. detecting utilities.
  454.  
  455. Scan 3.1v60 (c) 1989-1990 McAfee Associates
  456. PK[un]zip v1.1 (c) 1989-90 PKWARE INC.
  457. Lharc 1.13 (c) Yoshi 1988-1989
  458. Zoo 2.01 (c) 1988 Rahul Dhesi
  459. PK[un]pak v3.61 (c) 1986-1988 PKWARE INC.
  460. PAK v2.1 (c) 1988-1989 NOGATE Consulting
  461.  
  462. A.C.S. and Archive Converter/Scanner are (c) 1990 Vic Rao
  463. A.C.S. Documentation is (c) 1990 Nick Itsou
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.                                 4
  481. NI (Smile, it wasn't THAT bad =)
  482. -EOF-
  483.